Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / CD_TOOLS / CDP_126.ZIP;1 / CDP.DOC next >

Wrap

Text File | 1992-09-29 | 29.9 KB | 610 lines

CDPlay Version 1.26 September 29, 1992 This program is Copyright 1992 by Randy Rathbun. Turbo C++ is Copyright 1987, 1990 Borland International, Inc. Microsoft CD-ROM extensions Copyright Microsoft, Inc. This program is Shareware. You are granted a trial period of ten (10) days to try it out. If, after this period, you continue to use it, you must register it by sending $10US + $3US for Shipping and handling to Randy Rathbun. See the Order Form at the end of this document for more information. For the most up to date Shareware version of CDPlay, call The Ham Shack BBS at (816)796-6695. 24 Hours, 300/1200/2400 Baud, no parity, 8 data bits, 1 stop bit (FIDONET 1:280/19 - file freqable as CDPLAY.ZIP) -or- The Sounding board BBS (816) 361-9294, 24 Hours, 300/1200/2400 baud, no parity, 8 data bits, 1 stop bit (FIDONET 1:280/32 - file freqable as CDPLAY.ZIP) Disclaimer The author (Randy Rathbun) is not to be held liable for any damages caused by the use or misuse of this program. This pro- gram is provided 'AS-IS' with no warranty, either expressed or implied. Owners of the REGISTERED version of CDPlay are granted a one (1) year warranty on the media in which CDPlay is distributed. Owners of the REGISTERED version must send their original CDPlay disk (+$3US for postage and handling) to Randy Rathbun, 18602 Cheyenne Drive, Independence, MO 64056. Terms of Distribution Since CDPlay is Shareware, you may not sell it. Only the author (Randy Rathbun) may sell the program as a REGISTERED COPY. You may not charge others for this (Shareware) program. It must be given away. Users groups and other commercial interests (Shareware distributors, for example) may charge a small fee for the media on which CDPlay is distributed. This fee may not exceed $5 for magnetic media, and $1000 for optical media. Users groups and commercial interests which distribute CDPlay are encouraged to let me (Randy Rathbun) know that you are distributing CDPlay. We want to know how it is getting around! As a REGISTERED USER you are allowed to make copies of this program FOR YOUR OWN USE. This includes things such as install- ing it on your hard drive, making backup copies, etc. Since you have a REGISTERED version, if we find that you have made illegal copies of this program, we will send our friend, Vinnie Goombatz, over to rip your lungs out. In other words, DON'T GIVE COPIES OF THIS PROGRAM TO YOUR FRIENDS! (by the way, we were just joking about Vinnie. But if you do partic- ipate in this illegal activity, we will be mighty hurt.) A copy of the latest SHAREWARE version is included on the distribution disk for you to pass around. Introduction CDPlay is a full featured program which will allow your CD- ROM player to play a CD Audio disc. In order for CDPlay (herein referred to as CDP) you need to have the following: - A IBM Compatible computer - A CD-ROM drive capable of audio output - MSCDEX v2.1 or later If you have the items listed above, you are all set to start enjoying CDP! Note: Your CD-ROM device driver MUST support Audio Play- back. We have encountered a few users whose device drivers do not support audio. If CDPlay does not run, check with the drive manufacturer for an updated device driver. Optional equipment: - A Microsoft/Logitech compatible mouse - A Hard drive (although a floppy will work) Version 1.26 Features This is a major update to previous versions of CDPlay. It incorporates all previous updates from 1.24 in it. My spelling has been checked again and again throughout the screens. The Music Bar has been done away with, sort of. Instead of it, you can now select songs directly from the song title window. The size of the song titles has also been enhanced, allowing for easier identification of some songs (ie. Classical pieces). An update after 1.24 (I call it 1.25, but it was never released) which is incorporated into 1.26, allows the user to select whether or not they want direct screen writes. By using this, the user will have super fast screen writes. By not using it, things will slow down considerably, but may help some prob- lems that may be occurring in certain window packages. Sorry, but I can't use these on my 8088, so I can not test to be sure. Besides, I don't like windowing systems! Version 1.24 Features Problem with program displaying track number in hex fixed, I think. Unfortunately, this problem only occurred on certain machines... mine was not one of them. Version 1.22 Features Version 1.22 does away with the three second delay to deter- mine if a disc is playing when CDPlay initially loads. Getting Started In order for CDP to start working, you need to run the program CDPSETUP. This program will write the following files to your system: CONFIG.CDP (8 bytes) CDPDISC.DAT (0 bytes) CDPSONG.DAT (0 bytes) CONFIG.CDP contains startup information for CDP to use. It has a file length of 8 bytes. CDPDISC.DAT and CDPSONG.DAT will both have file sizes of 0 bytes, but don't worry! They don't have any information in them yet. During the running of CDP, you will see two other files appear on your system: CDPDISC.BAK CDPSONG.BAK These are backup files of CDPDISC.DAT and CDPSONG.DAT. They will be discussed a bit later. Now, back to CDPSETUP. You will be asked for the amount of time for the screen saver to become active. The value you enter is in minutes, from 1 to 30. The screen saver will become active after the number of minutes you specify if there has been no keyboard or mouse button activity. Next, you will be asked if you want Direct Screen Writes. Tell it yes. If you have problems while running CDPlay, run CDPSETUP again, and change your answer to no. **************************************************************** NOTE: If you are upgrading from a version of CDPlay less than 1.26, you MUST RUN CDPSETUP! A new feature (direct screen writes) has been added and the program MUST know what you want. **************************************************************** Running CDPlay To run CDPlay, just type: CDP <Enter> at the DOS prompt. CDP will load and you will soon be greeted with the main program screen. The Database The Database section of CDP is very simple. It allows you to see just what is on a disc, what disc is in the drive, the times of each track, and the disc artist. It also allows you to search your database to find a song. Suppose that you have every disc that the Rolling Stones currently have out, and you want to find out which discs contain the song "Jumpin' Jack Flash". The Search portion of the data- base will tell you. How To Enter A Disc Into The Database Entering a disc into the database couldn't be easier. Just insert a disc into the CD-ROM drive. CDP will check your current database entries for that disc. If CDP cannot find the disc, you will be prompted to enter the disc information. To add the disc, just follow the prompts. You will first be asked to enter the Title Of The Disc. You have 80 characters for each field. As you type, your cursor will move from left to right. When you get to what appears to be the end of the field, the text will start to scroll from right to left. Next, you will be asked to enter the Disc Artist. This is usually a particular singer or group. If the disc is one of the 'CD Samplers' with songs from many artists, it is suggested that you type 'Various' in this field. After you have entered the disc name and artist, you can start entering the title of each track. Again, you have 80 characters to describe each track. If, for some reason, you do not feel like entering all this information, but would like to enter it at a later time, you can. Just press ENTER for each field. The information will be stored in the database this way, but can be changed. See the section entitled 'Editing an Entry' below. Editing An Entry If you find you have made a mistake on an entry, or wish to enter some information which you have previously skipped, you can. First, insert the disc whose database entry you wish to change into the drive. CDP will read the information out of the database and will display it on the screen. Next, press Alt-E or click the mouse on the Edit button. You will be presented with the Entry/Edit screen. You can use the normal cursor control keys to scroll around the fields and change them. If you wish for a field to remain as it is, just hit ENTER to go on to the next field. Searching The Database Searching the database is as easy as entering information into it. Press Alt-S or click the mouse on the Search button. You will now see the Search Query screen. You are asked to enter a song title, or part of a song title. Enter this and press ENTER. The disc title, artist, and song title will be displayed. Press any key to continue searching. For example, say you want to find all songs titles that contain the word 'love' in them. Enter 'love' in the search field. The database will show you all the songs you have entered which have 'love' in the title. Note that the database will also show you songs titles which also have the word 'lovely', 'clove', 'glove', and 'loved'. This is normal. To exit a search at any time, press the ESC key, or press any other key to continue the search. The Player Section Now for the good stuff, the actual disc player! I am assuming you know how to use the mouse by now, so I will not refer to it any more in this document. Just assume that when I say something like "Press the P key" that you can also press the Play/Pause button with the mouse. So go ahead. Press the P key! This is the Play/Pause key. It will start a stopped/paused disc and pause a playing disc. The S key will stop a playing disc. When you press Play, it will start over at the beginning of the disc. The + and - keys will allow you to jump forward or backward one track. If you try to jump forward when listening to the last track, it will be ignored. If you try to jump backward while listening to the first track, it will start over at the beginning of the song. By pressing the < and > keys, you will jump forward or back 10 seconds on the disc. Please note that this is not 10 seconds relative to the song, but 10 seconds relative to the disc. If you press E, you will eject the disc from the drive. You can also eject the disc by hitting the EJECT button on the front of your CD-ROM drive. The Q-Channel Information The CD Audio disc Q-Channel information is constantly dis- played on the left side of the Player Interface. Q-Channel information is the time that is encoded on the disc itself. Please note that the times that are displayed do not always look correct, but they are. For example, you might notice that the Elapsed Track Time is somewhere around two (2) seconds behind the Elapsed Disc Time. This is normal. The Q-Channel information is displayed as: Track : (current track playing) Elap. Time: (elapsed Track Time) Song Time: (Time of TRack) Elap. Disc: (Elapsed Disc Time) Total Disc: (Total running time of disc) Status : CD Player status Track shows the current track number that is playing. Elap. Time is the elapsed running time of the currently playing track. Song Time is the total running time of the track. Elap. Disc is the elapsed running time of the currently play disc. Total Disc shows the total running time of the disc. Status shows the current status of the CD player. It will show Playing, Paused, Stopped, or Door Open. The Song Window By clicking the mouse on a song title in the Song Title window, you can jump directly to that song and it will start playing. This can be done from either a stopped or playing disc (thanks to all the users for suggesting this!). This should make the program a bit more flexible if you use it in a DJ capacity and want to access a song way into the disc. Other songs can be selected in the window by clicking the mouse on the UP and DOWN arrows. This will scroll through the list of songs. If a song is currently playing, and if it is shown in the window, it will be highlighted. Exiting the Program You can exit the program at any time by pressing the F10 key. When you do exit the program, any currently playing disc will continue to play, so that you can continue to listen to music while you use your computer. Note that there is no mouse button available for this. This is intentional - it keeps you from accidentally hitting the mouse button and exiting the program. It had originally been placed in the program, but while programming we kept leaving the program accidentally! Regular Maintenance Like all things, in order to keep your program running smoothly, you should perform some regular maintenance on CDPlay. This involves nothing more than backing up four files: CDPDISC.DAT CDPSONG.DAT CDPDISC.BAK CDPSONG.BAK These files are your database. If you loose them, you have to start entering the information all over. Believe me, it has happened to me many times. If, for some reason, your database becomes corrupted, there is only one way to restore it. Delete the files CDPDISC.DAT and CDPSONG.DAT, then run CDPSETUP again. Again, make sure you make backups of the database every so often. If you do not, you will have to re-enter all that infor- mation! IT IS NOT FUN! Copy the files over to a floppy and put it in a safe place. That way, if you accidentally destroy the database, or it becomes corrupted, you can easily restore it. Remember, "The stingy man spends the most!" Closing Comments We hope you receive much enjoyment from using CDPlay. A lot of hard work and effort went into the creation of this program. I would like to thank Dave Perry, W4KGU, and Craig Martin, WA0WPJ, for their help and especially for allowing me to bounce ideas off them. Thanks also go to Frank Gunja, N0FMR, for being a very helpful Beta tester. Fortunately I did not screw up his system! I would also like to thank all the creators of the Commercial CD player programs. If it wasn't for their extremely high priced do nothing programs, I wouldn't have written this one! Note to Some Drive Users It has been brought to my attention that some CD-ROM drives will do things that you are not expecting. The most common one I have heard of is with a couple models of NEC drives. It seems that even when a disc is not in the drive, the BUSY light stays on. The reason for this, after talking with a rep from a NEC dealer, is that the drive BUSY light is on whenever a) the drive is playing a disc or b) a program is accessing the drive for information - which CDPlay does all the time. Even when there is no disc in the drive, CDPlay monitors the drive to see if a disc has been inserted. It also watches the drive when a disc is stopped, to see if the user has ejected the disc. So if you see your busy light on all the time, it is just CDPlay! Another problem seems to be occurring with the new low priced drives from Radio Shack and a few others. Due to the SLOW times of these drives, CDPlay slows way down also. It seems to take forever to jump back and forth between tracks. This is not due to CDPlay. This program can only run as fast as your drive supplies it with information. BIOS Problem? I have been receiving some complaints from a few users about the way in which CDPlay shows the track number. After many hours of work and a lot of consultation with C programmers, we have come to the conclusion that this is a BIOS problem. If your machine counts like this: 1, 2, 3, 4, 5, 6, 7, 8, 9, 16, 17, .... please let me know! I need the following information from you: Drive manufacturer/model number MSCDEX version number drive manufacturer's device driver version number BIOS manufacturer and version Make/model of computer This data will be collected and sent to the BIOS maker. Who knows what other programs you may have that are being effected by this same bug! About the Author Randy Rathbun, NV0U, is a graduate of the University of Missouri at Kansas City withe a degree in Computer Based Informa- tion Systems. He received his amateur radio license in April 1985 (KA0UMC). Other than computers and ham radio, Randy's hob- bies are home beer/wine making, listening to blues music, reading science fiction, and stamp collecting. User Notes CDPlay was written in Turbo C++. It was written using a Sony CDU-510 CD-ROM drive, MSCDEX v 2.21, MS-DOS 5.0, and an 8088 IBM Compatible computer. CDPlay should work correctly with ANY CD-ROM drive, provided the driver program manufacturer has stuck with the Microsoft CD ROM Extensions Device Driver specifications. CDPlay does not talk to the drive, like some drive specific programs do, but talks to the CD-ROM extensions which in turn talks with the drive. This makes for a more compatible program. If, after you have tried everything you know of to get the program running, and it still does not work correctly then WRITE US A LETTER! We want to know! Please include the following information to us in your letter: - a printed copy of your AUTOEXEC.BAT file - a printed copy of your CONFIG.SYS file - what version of MSCDEX you are running - what version and what device driver you are using We will try our darndest to help you get the program running. Versions Released or Versions We Worked On CDPlay Version Date Changes made 1.26SR 920929 (sound of 'Taps' being played). Death to the Music Bar! Now you can access a song directly in the display window. Also made the display window larger to display song names with HUGE titles, ie. classical music and Mojo Nixon's 'Debbie Gibson Is Pregnant With My Two Headed Love Child.' The main screen layout has also undergone major rest- ructuring. The documentation included in both the Registered and Shareware versions are the same. I got sick of editing two different files each time I had an upgrade. 1.25SR*# 920901 Added support for both direct and BIOS screen writes. This should make the program work a little better under some windowing systems. Sorry I can't test this out to be sure. This XT does not multitask too well! 1.24SR 920702 Corrected problem with program displaying track numbers above 10 in hexadecimal. 1.23SR 920401 Corrected a small typo. 1.22SR 920327 Did away with three second delay when the program is executed. CDPlay now checks a status bit to see if the drive is playing an audio disc upon startup. 1.21SR 920323 Made some additions to the registration information to cut down on confusion. Also fixed problem with Search routine showing duplicate information when the search criteria matched the last disc in the database. 1.20SR 920311 MAJOR BUG FOUND! The way which CDPlay wrote the database meant certain death for anything that was already in the database. This bug has been fixed. Sorry for any problems. Free copies sent to all REGISTERED users. 1.12S 920221 Made changes to annoy screen. No longer sits forever. Also cut down on number of times that the screen is displayed. 1.11SR 920216 As usual, I got ahead of myself and did not pay attention to what was being put on the screen. So this version does not do anything differently, it just corrects my failure to read what I wrote in the help screen. Uploaded to Ham Shack BBS only. 1.10SR 920211 Release of updates. 1.05# 920210 Made change to annoyware screens instead of cripple ware. Lowered price to $10. 1.04# 920209 Corrected problem in search routine. Can now exit a search. No longer have to go through every entry. 1.03# 920208 Added Music Bar to screen. Fixed problem with mouse acting too quickly. 1.02a# 920207 Made room in code for password registration. This will not be done until much later (say v1.20 or later). 1.02# 920205 Moved the screen format around to facilitate the new upcoming features. 1.01S 920118 Fixed typo in order screen, along with other small typos. The CDPlay release also contains CDPlay Quick Start. 1.00S 920115 First Shareware Version Released! 0.60B 920111 Fixed bugs (screen) introduced in v0.22B 0.50B 920110 Fixed stop disc function to return to beginning of disc. 0.22B 920107 Released BETA TEST version. Contains fix for initial startup recognition of playing disc. 0.21B 911219 Initial BETA TEST of CD Play 0.01B 910921 Start of CDPlay coding. NOTE: * indicates changes made to CDPSETUP. # indicates version not released. S indicates Shareware version. R indicates Registered version. B indicates Beta version. CD Play Product Order Form Name: __________________________________________________________ Address: _______________________________________________________ City: _____________________________ State: _____________________ Zip: ____________________ Version you are registering _____________ Media type: ________ 3.5" ________ 5.25" ______ units @ __$10__ ea. = _______ + shipping 3.00 TOTAL _______ Send your Check/Money Order payable to Randy Rathbun to: Randy Rathbun 18602 Cheyenne Drive Independence, MO 64056-2082 International orders must be in United States Funds ONLY. Inter- national orders should add $3.00US for increased shipping costs. From where did you receive this program? (if a BBS, list its name/phone number: ______________________________________________ Please let us know what you think about the program! Are there any things you would like to see added or changed? Is there anything that is not working properly for you? Drop us a note (or write it on the back of this form if you print it out). Remember, we may write it, but you are the ones that use it! For our use only: PIDNO: ___________________________________________________ TYPE: ________